package com.example.dao;

import com.example.entity.Product;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 商品数据访问接口
 * @author System
 * @date 2024
 */
public interface ProductDao {
    
    /**
     * 根据ID查询商品
     * @param id 商品ID
     * @return 商品信息
     */
    Product selectById(Long id);
    
    /**
     * 查询所有商品
     * @return 商品列表
     */
    List<Product> selectAll();
    
    /**
     * 根据状态查询商品
     * @param status 状态
     * @return 商品列表
     */
    List<Product> selectByStatus(Integer status);
    
    /**
     * 根据分类查询商品
     * @param category 分类
     * @return 商品列表
     */
    List<Product> selectByCategory(String category);
    
    /**
     * 模糊查询商品
     * @param keyword 关键词
     * @return 商品列表
     */
    List<Product> selectByKeyword(String keyword);
    
    /**
     * 分页查询商品
     * @param offset 偏移量
     * @param limit 限制数量
     * @return 商品列表
     */
    List<Product> selectByPage(@Param("offset") int offset, @Param("limit") int limit, @Param("category") String category);
    List<String> selectCategories();

    /**
     * 统计商品总数
     * @return 商品总数
     */
    int countAll( @Param("category") String category);
    
    /**
     * 根据状态统计商品数
     * @param status 状态
     * @return 商品数量
     */
    int countByStatus(Integer status);
    
    /**
     * 根据分类统计商品数
     * @param category 分类
     * @return 商品数量
     */
    int countByCategory(String category);
    
    /**
     * 插入商品
     * @param product 商品信息
     * @return 影响行数
     */
    int insert(Product product);
    
    /**
     * 更新商品信息
     * @param product 商品信息
     * @return 影响行数
     */
    int update(Product product);
    
    /**
     * 更新商品状态
     * @param id 商品ID
     * @param status 状态
     * @return 影响行数
     */
    int updateStatus(@Param("id") Long id, @Param("status") Integer status);
    
    /**
     * 更新商品库存
     * @param id 商品ID
     * @param stock 库存
     * @return 影响行数
     */
    int updateStock(@Param("id") Long id, @Param("stock") Integer stock);
    
    /**
     * 删除商品
     * @param id 商品ID
     * @return 影响行数
     */
    int deleteById(Long id);
    
    /**
     * 批量删除商品
     * @param ids 商品ID列表
     * @return 影响行数
     */
    int deleteByIds(@Param("ids") List<Long> ids);
}